Edit a SAPI Voice Message with Polaris Language Editor
The following steps summarize how to edit a SAPI voice message for inbound or outbound telephony. For more information about using the Language Editor, click the Help tab in the Language Editor.
Note:
You need the Polaris permission WebAdmin access: Allow to use the Language Editor.
- Open your Web browser and navigate to the Language Editor site on your server.
The Log On page opens.
- Type your name, password, and domain name, and click OK.
The Language Editor opens and the Edit page is displayed.
- In the Product box, select Inbound Telephony or Outbound Telephony as appropriate.
- Select the organization for which you are making the modification.
Note:
For outbound telephony where there are multiple telephony servers, one organization’s set of messages must be specified for use by each server. See Set General Telephone Notification Parameters.
For inbound telephony, if each phone line is associated with a different organization, and each organization offers different options and custom messages such as announcements, each organization has its own messages and associated .wav files. The path and URL for each organization’s files are specified in the configuration utility. See Set Phone Attendant Options for Specific Lines.
- Select languages to compare and edit in the Language 1 and Language 2 boxes.
Only languages that are licensed are available for selection. Select two languages (for example, English and Spanish) to compare the equivalent message strings side-by-side. If you want to edit only one language, for example English, set both languages to English - United States.
- (Optional) To limit the language strings that will be displayed, select one of the following options:
- Specific string ID - Each language string is identified by a unique identification code. If you want to display a specific language string and you know the code, enter it here.
- String contains - You can display language strings that contain specific text. Enter the text here.
- Only show customized language strings - Check this box to limit the list to strings that have already been customized.
- Click Load Strings.
The strings are displayed in a table with the first language on the left and the equivalent string in the second language on the right. The string ID is displayed above each string for both languages. If you have set both languages to the same choice, the table shows only one language. Click Previous Page and Next Page to navigate through the results.
- Click
to edit a string.
The custom box for the string opens.
- Type your custom text in the Custom box, and click
to save your changes. (You can click
to restore the default value.)
After you save your custom text, the string is labeled Custom: and the custom text is displayed in a different color. You can click
to open the custom box again, or click
to restore the default value.
Tip:
You can edit the Phone Attendant’s library hours and announcements as you would any other messages. The library hours message name is PA_TEXT_LIBRARYHOURS. The message name for announcements is PA_TEXT_ANNOUNCEMENTS.
Important:
Do not edit the name of the message or (for Phone Attendant) the menu option numbers. Also, do not edit circulation variables. You can identify these by the $% signs that precede them. For example, in the message PA_TEXT_PATREC_ACCOUNTSTATEMENT_CHARGES
You have outstanding charges of $%3.2f
the actual amount of charges is drawn directly from the patron record, and is represented by the variable $%3.2f. You can edit any other text in the message.
- Click Log Off to end the current session.
- Stop telephony services.
- Open the appropriate .wav file folder, which contains the converted text messages.
The default location for outbound telephony is:
C:\ProgramData\Polaris\[version]\[datalink]\WaveFiles\Outbound\
[language folder]\Cache
The default location for inbound telephony is:
C:\ProgramData\Polaris\[version]\[datalink]\WaveFiles\Inbound\
[language folder]\Cache
where [version] is your Polaris version number, [datalink] is your network database location if any, and [language folder] is a number that corresponds a specific language. See Text-to-Speech Conversion.
- In the Cache folder, delete the .wav files for the messages you edited. Do not delete the folder itself; delete only the appropriate .wav files.
Note (Inbound telephony):
If you edited many messages, you can delete all the files in the appropriate .wav folder. However, performance may slow somewhat when the first calls come in, as the text messages are converted to new .wav files the first time they are used. That is, a new .wav file is created when the first caller attempts to access the message. If you would like to avoid long pauses for the first callers, call the inbound telephony service and invoke the new messages before patrons use the service.
- Restart the phone service.
Note (Outbound telephony):
The .wav files are regenerated when the service is restarted.
Related Information
- Record your own .wav files - Instead of using the .wav files created when text is converted to speech, you can record and manage your own .wav files using the Polaris Telephony Voice Recorder. See the Voice Recorder help file for more information.
- Adjusting pronunciation - You can change the way SAPI voices pronounce specific words. See Adjusting Pronunciation.